home *** CD-ROM | disk | FTP | other *** search
/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / FILECOPY / UPDATE.ZIP / UPDATE.DOC < prev    next >
Encoding:
Text File  |  1993-07-07  |  3.5 KB  |  91 lines
  1. UPDATE.EXE version 1.1
  2.  
  3.   SYNTAX:  UPDATE.EXE <Source Path> <Target Path> <File Spec>
  4.  
  5.   The UPDATE Utility will search the <Source Path> file for
  6.   files matching the <File Spec> and then search the <Target Path>
  7.   for exact matches.
  8.  
  9.   If a file found in the <Source Path> is not found in the
  10.   <Target Path> then the file is ADDED to the <Target Path>.
  11.  
  12.   If a file is found in the <Source Path> and in the <Target Path>
  13.   and the file found in the <Source Path> is newer, then the file
  14.   is UPDATED (overwritten) in the <Target Path>.
  15.  
  16.   EXAMPLE:  UPDATE.EXE c:\adf_file\ a:\ *.adf
  17.  
  18.   The example above will find for any files that match the
  19.   wildcard "c:\adf_file\*.adf" and if they are not found on
  20.   the "a:\" directory the will be copied there.  If a file with
  21.   the same name does exist on the "a:\" directory the file dates
  22.   are compared and the file is copied only if newer that that on
  23.   the "a:\" directory.
  24.  
  25. Why I Needed This Program:
  26.  
  27. I regularly service IBM PS/2 computers which require a reference
  28. disk to run the system configuration program.  This disk contains
  29. configuration programs and data files.  As with any software, IBM and 
  30. other adapter card manufacturers regularly revise these data files 
  31. and distribute them.  When I service a machine I want only the most 
  32. most current setup files (*.ADF) on my reference disk.    
  33.  
  34. I needed to copy new files not currently on the reference disk and  
  35. overwrite older files on the reference disk with newer files - but,
  36. I DON'T WANT TO OVERWRITE A NEW FILE WITH AN OLD ONE!!!  So updating
  37. a reference disk was a tedious manual operation.
  38.  
  39. The external DOS command REPLACE.EXE is similar. It has a the "/a"
  40. switch to add new files and also the "/u" switch to replace older
  41. files but they are mutually exclusive.  A batch file with two passes
  42. could get the job done but I think you will agree that UPDATE.EXE
  43. is more user friendly.
  44.  
  45. I originally wrote the UPDATE.EXE for this specific task.  Then I
  46. started getting comments about how useful this would be for other 
  47. tasks.  I rewrote the program to accept the <SOURCE>, <TARGET> and
  48. <FILESPEC> arguments to make it more flexible.
  49.  
  50.  
  51. Historical Stuff:
  52.  
  53. Version 1.0  Written 01/25/93
  54.  
  55. Version 1.1  Written 07/07/93 Added escape capability to allow
  56.              pausing and/or aborting an update operation.  Added
  57.              a pause when a file cannot be copied for some
  58.              reason.  User may then continue or abort.
  59.  
  60.  
  61. Legal Stuff:
  62.  
  63. This program is released to the public domain (freeware) by me, the
  64. author.  It is provided "AS IS" and the author assumes no liability 
  65. for your use of this program.
  66.  
  67. You may distribute this program provided you do not charge any 
  68. fees and you distribute this text file with the program.
  69.  
  70.  
  71. Technical Stuff:
  72.  
  73. I have tested UPDATE.EXE sucessfully in the following environments:
  74.  
  75.     MS DOS 4.01, 5.0
  76.     PC DOS 4.0, 5.0
  77.     Windows 3.X (DOS session)
  78.     OS/2 1.3, 2.0 (DOS session)
  79.     
  80. The program was written and compiled in Microsoft QuickBASIC version 
  81. 4.5 with additional library routines provided with the book "Basic 
  82. Techniques And Utilities" by Ethan Winer,  Ziff-Davis Press.  I 
  83. highly recommend this book to anyone who desires to use QuickBASIC
  84. for more than the NIBBLES.BAS program shipped with DOS 5.  If you 
  85. have a basic compiler and would like the source code then send me a 
  86. message on Compuserve I will gladly send you the 350 line basic 
  87. source code for UPDATE.EXE.
  88.  
  89. John Lindinger, Compuserve ID# 71072,1402
  90.  
  91.